home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD 2.1 / Amiga Developer CD v2.1.iso / Reference / Amiga_Mail_Vol2 / Archives / Plain / ja90 / MIDIARexx.txt < prev    next >
Encoding:
Text File  |  1991-01-22  |  4.4 KB  |  99 lines
  1. ARexx Command Set for MIDI Sequencers (Preliminary)
  2.  
  3. by Darius Taghavy
  4.  
  5.  
  6. The release of version 2.0 of the Amiga's OS has made ARexx
  7. an integral part of the system.  ARexx macros are going to become a
  8. widespread method of tying together applications.  It is important
  9. that every category of application support their own common nucleus of
  10. commands.  Not only will this make usage of ARexx commands on the
  11. command line level more consistent, it will also allow for the
  12. creation of truly generic macros.
  13.  
  14. Because of its specialized focus, MIDI software needs its own set of
  15. standard ARexx commands.  The chart on the following page is the
  16. preliminary standard set of ARexx commands for MIDI sequencers.
  17. Comments and suggestions for improvements are welcome.  
  18.          
  19. Please direct any comments or suggestions to:
  20.  
  21.                 Darius Taghavy
  22.                 Commodore Business Machines
  23.                 1200 Wilson Drive
  24.                 West Chester, PA 19380
  25.  
  26.  
  27.         I can also be contacted via e-mail at:
  28.  
  29.                 darius@cbmvax.commodore.com
  30.  
  31.                           or                 
  32.  
  33.               ...{rutgers|uunet}!cbmvax!darius
  34.  
  35.  
  36.  
  37.           THE STANDARD MIDI AREXX COMMAND SET (PRELIMINARY)
  38.  
  39.  
  40. command  |      para1            para2      comments
  41. ----------------------------------------------------------------------------
  42. TEMPO    |        n                     set tempo to n beats per minute
  43. SIGNATURE|       a:b                    set time signature to a/b
  44. FRAME    |   24/25/29/30                set SMPTE frame rate, 29 represents
  45.      (1) |                              30 drop frame
  46. ----------------------------------------------------------------------------
  47. START    | BEAT/SMPTE/CLOCK        n    start playback at position n or at 
  48.          |                              current position if no parameters
  49. RECORD   | BEAT/SMPTE/CLOCK        n    start recording at position n or at 
  50.          |                              current position if no parameters
  51.          |
  52. STOP     |                              stop playback/record
  53.          |
  54. LOCATE   | BEAT/SMPTE/CLOCK        n    advance clock to position n, returns
  55.          |                              current position if no para2
  56.          |
  57. WAIT     | BEAT/SMPTE/CLOCK        n    causes receiver to wait for position 
  58.          |                              n to return message
  59.      (2) |
  60. ----------------------------------------------------------------------------
  61.          |
  62. OPEN     | TRACK/PAT/SEQ/SONG     name  destructive loading (loaded data will
  63.          | SETUP/SAMPLES/ALL            overwrite data currently in memory)
  64.          |
  65. SAVE     | TRACK/PAT/SEQ/SONG     name  save data to file "name"
  66.          | SETUP/SAMPLES/ALL
  67.      (3) |
  68. ----------------------------------------------------------------------------
  69.          |
  70. PRELOAD  | name                         nondestructive loading (allocates RAM
  71.          |                              and loads song "name" into RAM buffer)
  72. INSTALL  | name                         REMOVEs "name" from RAM buffer and 
  73.          |                              INSTALLS it in playback buffer     
  74. REMOVE   | name                         deletes "name" from memory buffer and
  75.      (4) |                              deallocates memory
  76. ----------------------------------------------------------------------------
  77.          |
  78. ACTIVE   | TRACK/PAT/SEQ     UP/DOWN/k  inc/dec currently active TRACK/PAT/SEQ
  79.          |                              or directly activate TRACK/PAT/SEQ k
  80.          |                              returns currently active TRACK/PAT/SEQ
  81.          |                              if para2 is missing
  82. ----------------------------------------------------------------------------
  83.  
  84. Notes: 1> calling TEMPO,SIGNATURE or FRAME with no parameters returns current
  85.           values
  86.  
  87.        2> format for n (START,RECORD,LOCATE and WAIT) depends on para1
  88.           if para1= BEAT , n is bars:beats     (depends on SIGNATURE)
  89.           if para1= SMPTE, n is hours:minutes:seconds:frames (depends on FRAME)
  90.           if para1= CLOCK, n is number of MIDI clock pulses (24 ppq)
  91.  
  92.        3> SONG includes TRACK, PAT and SEQ 
  93.           ALL includes SONG, SETUP and SAMPLES
  94.  
  95.        4> PRELOAD,INSTALL and REMOVE allow you to have multiple songs in RAM
  96.           to avoid delays between songs in live performance. Dynamic memory
  97.           allocation via OS methods allow you to queue up as many songs as 
  98.           memory permits.
  99.